E Make It Yours. 


Contents 
OVervieW s ———————————————————————"Á—Á—— 3 
Ehl4.r-[ cc ———————————————————————————————————————— 4 
1..Sample:execütion file... corteo pepererat ina puer eau n ea Vorne xk au UR EERER oe EYR SWR EE DEAN od E YR SR ER FEDERE av RRY eR Veo EBERT e RENE RR waa 4 
LERTTPIDEBIUD Jp HNE—————————————Á 4 
3: Sample Tg nilme———————————————————— 4 
(II) SDK: directory cContent.............. 1t uro o eoo n eeu nno oco on axe a ago rato Xe ya agua a6 E Co ono Ea eaa eas Ca Cao eaa N aa wa ER EE o EUER NE ERNER 4 
1. CoolerMaster LED Table.xls: LED Matrix (6 row x 22 Column) ....................... eese eee eee eene eene nennen nnne nn nnn notte nn nu 4 
2. SDK Function.doc: function instructions provided ............sssssecscssssssssssscecsecscenssssessecseesesnanssssseseesecseanssssseseeseesoanees 4 
3. x86 directory: dynamic link libraries, Lib file and header file.............................cceeeee eese cerne eene nee nnne nnne nnn 4 
CPI HIIPHPCERTNTET ORT TITIO TI ELE TMM———————————————— 5 
Supported Devices ............::.: too rna e orsa o oo sana au soup aaa E or pa RR E SE pu REDE SE Ry AR E SERRREII PRESE NESE NESS ENSS KASS NSSR NES EVES SENSARS SESS Rasa 5 
MOLDDLID ET ——————————Á————————————M— RE 5 
MOUSE ————————————————————————— 5 
ual» ————————————————————————————À 6 
SDK Related Definitions e——————————————— 6 
LED: Lig ae A e ———————Á————————— 6 
Mndiadieelos—————————————————HÉÉR 6 
Struct COLOR MATRIX cm ———————————— 7 
uuididijem————————————————————— 7 
System data related function ...........iiiicieei cerros trito nena eran aao a npa yy E eR Y RR KE ELE UAE RR EE AR ERR IER SERRE ERRARE RIDERS EENES EnB T ARANNA 8 
TCHAR * GetNOwTime() ee—————————————————————————— 8 
LONG GetNOWCPUUSABE() mm———————————————PI 8 


Confidential. All rights reserved. 


E Make It Yours. 


DWORD: :GetRamUsage(l) .:.1::.::. eit eror ee pnu unt otio Ea en uova us SE oc NN RR Ye EXER RR e DEENR AREE RN REEL or NNRN Re NN RERR ocsenaseeesvevedessiuuseess 9 
float — GetNowVolumePeekValue() ............... 21:1 oia oorr pronun uno ra ero run u o hao ao ra rry nona aa RRgo ra pn A na RR RR RR RR ERR ARRA RR RR Ra Ran 9 
DEVICE: operation FUNCTION P —————— 10 
Void SetControlDevice(DEVICE_INDEX devIndex) ..........cccccccssssssssscececccesssnsssscececccsscacsssseesecesessaneasseseeeeeeees 10 
bool ISDeVICEPIUB() veececissecscsiveeccdenieesdeseveecsveneeecueudvasecduvdeceueuusssscetuenscucsusssresivenccdauuanessesvevscucsiabessscyetessebuabs 10 
LAYOUT KEYOBARD GetDeviceLayout() ....csccicccssssssesssssieccccscssenscessecsccsccsensssasscesssssnenasssaecesssessensosasssessseseenses 11 
bool EnableLedControl(bool bEnable) c.isscsecscccscccccscotesacedsstccssscoesasessceveasccbesasvdssseeascconsasvasssceacccbsansessasvesscconaes 11 
bool SwitchLedEffect(EFF INDEX iEffectlndex) ....................... e eeeeee eese eee een eene eene nennen nennen nn nnns nnus nne he sensns nu nan 12 
bool SetFullLedColor(BYTE r, BYTE g, BYTE b )......... rene eor eeu eoru o nr nana nne eua n nean a e aao eso e none een o Ia Enna 12 
bool SetAllLedColor(COLOR MATRIX colorMatrix ) ....................eeeeee eese e eene eene enne nennen nnns n nnn notte nnns ne nonas 13 
bool SetLedColor(int iRow, int iColumn, BYTE r, BYTE g, BYTE b ) ........................ eese enne enne nnne 13 
-l42cupnjJgemee——————————————— 14 


Confidential. All rights reserved. 


E Make It Yours. 


Overview 


The Cooler Master Maker Toolbox is a software development kit that gives you complete 
access to the code behind LED lighting on all of our peripheral products. With the controls in 
your hands and the ability to retrieve system data from your PC, your lighting can be 
programmed to change, for example, according to the music you play or the speed of your 


processor. Create a whole host of effects using basic C++ knowledge. 


Share your profiles with other Cooler Master peripheral owners at 


http://makerhub.coolermaster.com 
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SDK Package 


Example Folder: 


(I) Example directory content 
1. Sample execution file 
2. Sample source code; 
3. Sample description 
(II) SDK directory content 
1. CoolerMaster LED Table.xls: LED Matrix (6 row x 22 Column) 
2. SDK Function.doc: function instructions provided 


3. x86 directory: dynamic link libraries, Lib file and header file 
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Requirements 


Windows 7 (32-bit and 64-bit); 
Windows 8.1 (32-bit and 64-bit); 
Windows 10 (32-bit and 64-bit). 


Supported Devices 


Keyboards 


MasterKeys Pro L with RGB (SGK-6020) 
MasterKeys Pro S with RGB (SGK-6030) 
MasterKeys Pro L with White (SGK-4070) 


MasterKeys Pro M with White (SGK-4080) 


Mouse 


MasterMouse Pro L (SGM-4006-KFOA1) 
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Reference 


SDK Related Definitions 


LED Matrix SIZE 
MAX LED RO:6 
MAX LED COLUMN:22 


struct KEY COLOR { 
BYTE r; 

BYTE g; 

BYTE b; 

E 


6 
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struct COLOR MATRIX { 


Description: set/store entire LED Color structure 
KEY COLOR KeyColor[MAX, LED ROW][MAX. LED COLUMN]; 
y 


enum EFF INDEX ( 


Description: set/store entire LED Color structure Special effects list 
EFF FULL ON - 0, EFF. BREATH - 1, 

EFF BREATH. CYCLE = 2, EFF SINGLE = 3, 

EFF WAVE = 4, EFF RIPPLE = 5, 

EFF CROSS = 6, EFF. RAIN - 7, 

EFF STAR = 8, EFF SNAKE = 9, 

EFF REC = 10, EFF. MULTI. 1 = OxEO, 

EFF MULTI 2 = OxE1, EFF MULTI 3- 

OxE2, EFF MULTI 4 = OxE3, EFF. OFF = OxFE}; 
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System data related function 


TCHAR * GetNowTime() 


Description: Obtain current system time 

Function name : GetNowTime 

variable: 

return : TCHAR : string index format is 96Y 96m/96d 96H:96M 96S 


note: 


LONG GetNowCPUUsage() 


Description: obtain current CPU usuage ratio 
Function name: GetNowCPUUsage 

variable : 

returns : LONG : 0 ^ 100 integer 


note : 
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DWORD GetRamUsage() 


Description: Obtain current RAM usuage ratio 
Function name: GetRamUsage 

variable : 

returns : DWORD : 0 ^ 100 integer 


note : 


float GetNowVolumePeekValue() 


Description: Obtain current volume 
Function name : GetNowVolumePeekValue 
variable : 

returns : float : O ^ 1 float number 


note : 
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Device operation function 


Void  SetControlDevice(DEVICE INDEX devIndex) 


Description: set operating device 
Function name: SetControlDevic 
variable : DEVICE INDEX: device list 
DEV MKeys L, 

DEV MkKeys S, 

DEV MMouse M, 

returns : 


note : 


bool IsDevicePlug() 


Description: verify if the deviced is plugged in 
Function name : IsDevicePlug 


variable : 
returns: bool : true plugged in > false not plugged in 


note : 
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LAYOUT KEYOBARD GetDeviceLayout() 


Description: Obtain current device layout 
Function name: GetDeviceLayout 
variable : 

returns: LAYOUT KEYOBARD List: 
currently 3 LAYOUT UNINIT , 
LAYOUT US, LAYOUT EU 


note: 


bool EnableLedControl(bool bEnable) 


Description: set control over device's LED 
Function name: EnableLedControl 
variable : bool bEnable: 

true Controlled by SW, 

false Controlled by FW, 

returns : bool : true Success,false Fail 


note : 
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bool SwitchLedEffect(EFF. INDEX iEffectIndex) 


Description: switch device current effect 
Function name: SwitchLedEffect 


variable : EFF. INDEX iEffectIndex: index value of the effect 
returns : bool : true Success » false Fail 


note : 


bool SetFullLedColor(BYTE r, BYTE g, BYTE b) 


Description: set entire keyboard LED color 
Function name : SetFullLedColor 


variable : BYTE r :red, BYTE g :green, BYTE b :blue 
returns : bool : true Success > false Fail 


note : 
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bool SetAllLedColor(COLOR, MATRIX colorMatrix ) 


Description: Set Keyboard "every LED" color 
Function name: SetAllLedColor 

variable : COLOR MATRIX colorMatrix:structure, 
fill up RGB value according to LED Table 

returns : bool : true Success,false Fail 


note : 


bool SetLedColor(int iRow, int iColumn, BYTE r, BYTE g, BYTE b) 
Description: Set single Key LED color 

Function name: SetLedColor 

variable: int iRow: row, 

int iColumn:column BYTE r :red, 

BYTE g :green, BYTE b :blue 


returns : bool : true Success > false Fail 


note : 
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SDK example 


SDK examples illustrate 


Examples UI screen 


System Infomation 


r 
HB SDKExample 


System 2016 03/17 22:22 05 


CPU 7 Ram 73 Volume 0 


Select Device: |MasterKeys Pro L Y Set. 
LED Control LED Effect Choose: |Full ON y|| Set 


Set LED color for every key 


R 0 G: 0 B: 9 


Set Single Key Set ALL Key 


Set All LED 
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Development environment: VC ++ 2008 


1. System Information: for the user's computer to fetch the local system time, CPU 
usage, memory usage percentage, the current playback volume percentage. 

2. Select Device: to select the device that you want to control, the default option is 
MasterKeys Pro L. 

3. LED Control: can choose from enable and disable, in the disable state can switch 
effects; in the enable state can setup the keyboard LED color 

4. Set LED Color for every Key: is allowed to set different colors of each key, there are 
two ways to set up. One is to set a single Key; the other one is to set all keys on the 
keyboard to specified / different color. Please use the drop-down menu and select 
Row Column with "CoolerMaster LED Table.xls" table to determine the location 
specified color. 


5. Set All Led: set the whole keyboard as a single color quickly. 
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